ISCPersistenceUnit

A Persistence Unit encapsulates the information required to connect to an existing, outer level persistence unit within an application.

The following table contains the methods for the ISCPersistenceUnit interface:

Method

Description

VARIANT_BOOL DirtyBit()

Returns a flag that indicates that the data has changed in the persistence unit.

void DirtyBit(VARIANT_BOOL )

Sets the flag that indicates that the data in the persistence unit has changed.

VARIANT_BOOL HasSession()

Returns TRUE if a unit has one or more sessions connected.

VARIANT_BOOL IsValid()

Returns TRUE if self is valid.

ISCModelSet * ModelSet()

Passes back a pointer on the top model set in the Persistence Unit.

BSTR Name()

Passes back a persistence unit name.

SC_MODELTYPEID ObjectId()

Passes back an identifier for the persistence unit.

ISCPropertyBag * PropertyBag(VARIANT List [optional], VARIANT AsString [optional])

Returns a property bag with the persistence unit's properties.

A unit property is present in the resulting bag only if it has a value. If the property does not have any value set, the property bag will not have the property listed.

void PropertyBag(VARIANT List [optional], VARIANT AsString [optional], ISCPropertyBag * propBag)

Sets a persistence unit with the properties in the given property bag.

VARIANT_BOOL Save(VARIANT Locator [optional], VARIANT Disposition [optional])

Persists model data to external storage. Uncommitted transactions are ignored.

More information about property descriptions is located in the Property Bag for Persistence Units and Persistence Unit Collections section.